关键词：MediaWiki-1.34.2、Ubuntu 18.04、腾讯云、Wiki、VisualEditor、Parsoid

包含：Parsoid 404的一个解决办法，详见文末。

最近我在为学院的一个竞赛团队搭建一个团队wiki，用来储存并分享我们前期调研所收集到的各种信息。作为一种知识管理系统，wiki的内链做的相当方便，而且方便设置权限，便于多人协同工作，适合团队使用。

由于本人的专业与计算机完全不相关，所以在搭建站点的时候踩了很多坑，而在专业人士看来，这些“坑”甚至没有必要解释。经过一段时间的使用，我发现Wiki是一个很有效的知识分享工具，而这个工具不应当只存在于计算机“专业人士”的视野范围内。写这篇文章的目的，也是希望Wiki这种好的工具能够帮到更多需要知识管理的团队。

文章比较长，由于是面向零基础小白，所以基本算是从“开天辟地”讲起了；而门外汉写的文章，里面也肯定有很多知识性的错误和不恰当的操作。总之请多多包涵，也希望能帮到大家。

我选用了腾讯云作为我的服务器供应商。为什么选腾讯云呢，主要还是对其他两家主要的云服务器提供商（亚马逊云以及阿里云）不熟悉……如果你是学生，就使用腾讯云的学生认证，可以给你提供一个单核2G内存的服务器，一年大概120块钱左右。

本篇文章主题是公网wiki站点的建设，所以为了方便访问，同时也需要购买一个域名。建议也在腾讯云买域名，这样方便把域名解析（连接）到服务器的ip地址上。域名的价格和它后缀的文字有关。一般而言，众所周知的.com就比其他的文字要贵一些，这也算是市场经济规律。我买的域名是.top，因为刚好赶上腾讯云的优惠，五年的域名使用权只需要120元。

另外，强烈建议尽早购买域名！域名不是买来就能用的，而是需要经过实名认证和网信局备案的。这里有个坑：腾讯云的域名备案系统要求腾讯云账号注册48小时后才能备案，而登陆进去之后，系统会提示域名购买72小时之后才能备案。备案文件（主要是身份证照片和自拍）提交之后，腾讯云会打电话来确认信息，通过之后才能提交网信局备案。这个流程我到现在还没走完，所以我的wiki目前还只能用IP地址访问。

回到服务器的话题。当你购买服务器时，一般会有如下几个系统可选（截至2020.8.22）：

首先排除Windows，因为网络上针对Linux的教程要比windows多一些。其次，Linux的不同发行版（种类）之间，包管理器（下载服务时敲的代码）也稍有不同。Ubuntu据说是使用最为广泛的一种Linux操作系统（注：网上关于Debian的教程，Ubuntu也可以用），所以我就选了Ubuntu。尽管后来发现网上的教程更多还是针对CentOS，但Ubuntu里各种服务的下载还是相对更方便。

购买成功之后，你会获得一个初始密码，可以用于登录你的服务器。服务器不需要审核，可以随时使用。

强烈建议在你自己的电脑里下载WinSCP软件，输入[用户名]:[你的ip地址]后就可以登录，密码和服务器的密码一样。下载之后可以直接在系统之间传文件。

vncserver是一个远程桌面软件，安装费时费力，而且占用服务器内存相当严重，教程在此。大多数操作尽量还是在命令行里解决，这样占用内存相当少。但如果涉及到文字编辑，图形界面还是很有必要的。还是建议使用腾讯云自带的VNC登录方式，不要自己搭vncserver。

首先介绍下命令行的基本使用方式。

以上是基本的命令行操作方式。

之后重启[1]。

可选的软件包，为了以防万一还是全部安装上：

在此处选择clash-linux-amd64版本下载Linux版clash。

如果不熟悉Linux命令行，可以在本地解压后，将解压出来的clash-linux-amd64文件，用前述的WinSCP软件，拷贝至/home/ubuntu/clash[2]文件夹下面。之后定位至这个文件夹：

并修改该clash文件的权限，使得你可以执行它，并执行一次：

这时它将提示两个信息：

因为你现在没有代理，所以这个mmdb文件无法下载，需要你在这里手动下载。如果下来下来的是压缩文件，请先手动解压。

之后联系你的代理服务供应商，让他为你提供一个含有可用代理的config.yaml，里面应当包含和科学上网有关的各种服务器信息，以及一些代理策略。

打开你的config.yaml，检查代理策略里面不走代理，直接连接的策略（注意最后的[DIRECT]），一般是这样的内容（如果没有策略组，就手动加上）：

因为之后要涉及Ubuntu命令行中的下载，如果腾讯云的下载源走了代理，就会下不下来；但有些内容又必须要代理才能下载，所以需要手动设置代理策略，以绕开腾讯云的链接。

输入规则：

之后保存，并和Country.mmdb一同通过WinSCP软件上传至服务器端的/home/（用户名）/clash文件夹下。先删除clash刚刚建立的，空的config.yaml文件，再将这两个文件都拷贝至home/（用户名）/.config/clash文件夹下：

如果你是在图形界面操作，那你很有可能看不到.config文件夹，这是因为它是个隐藏文件夹。即使是在命令行里，用ls命令也看不到，但这不代表文件夹不存在。你可以用-a去显示全部的文件夹：

之后再删去原来的那个文件夹里的Country.mmdb文件：

请注意，现在已经有了两个clash文件夹，分别是：

这两个文件夹里的config.yaml文件要保持完全一致。

此时请使用腾讯云的VNC方式登录。输入账号密码之后，进入图形界面，在应用中找到terminal（终端），打开后定位至第一个clash文件夹，并运行clash

此时clash应该就能正常运行了。这时我们最小化（不要关掉）这个terminal，打开浏览器，输入http://clash.razord.top，在浏览器里完成clash本身的设置。首次打开时可能会要求你输入ip和端口，请在你刚刚上传到服务器的config.yaml中找到这两行：

然后在Settings里将策略改为Rule，这样才能个别地对网站进行代理，同时绕过腾讯云镜像。

随后在桌面左下角打开应用桌面，搜索settings，点击齿轮，在左边找到proxy标签栏。选择代理方式为manual（手动），在http代理和socks5代理中分别输入127.0.0.1和对应的端口。端口信息还是从config.yaml中获取，找到这两行：

以上设置完毕后，打开浏览器输入http://wikipedia.org，如果能正常访问，说明代理已经设置成功了。如果要关闭代理，首先打开刚才最小化的客户端，按ctrl+c关闭；其次打开设置，将刚才设置的manual改为disabled，两者都需要关闭，否则无法上网。如果想继续在terminal里操作，请新建一个terminal，并且不要关闭之前运行着clash的那个。关于订阅自动更新、clash应用图标设置等高级内容，请参阅Clash For Linux 安装及使用以及clash for linux 安装及配置自动订阅。

需要注意的是，图形界面设置的全局代理在终端中并不能直接使用，仍需手动配置环境变量，或修改命令的.conf文件（不推荐）。可以用下面的方式设置终端内的[3]。

这种方法能够对同一个terminal内的所有命令配置代理，但有时apt并不能成功。本教程中共有两个命令需要走以上设置好的代理，分别是：

亲测有效的代理配置方式各不相同，请参见基于Parsoid的扩展:VisualEditor一节。

当你配置完代理，并确认其可用之后，请立刻在运行代理的terminal窗口中按Ctrl+C终止代理程序，关闭terminal窗口，并在Setting中将代理模式设置为disabled。

如果你刚才（基于Ubuntu的基本环境配置-基本服务安装）已经成功安装了Apache，则你应该可以在防火墙的应用名单中看到Apache的身影：

然后查看Apache Full的档案，你应当可以看到它允许80和443端口的数据：

然后在防火墙中放行进入Apache Full的流量：

接下来，请试着找到服务器的公网IP。对于腾讯云服务器，其公网IP可以在控制台中找到。如果控制台中没有，可能是你的页面缩放问题，请将浏览器窗口最大化后刷新。

还有一种查看IP地址的方法：

此方法显示出的IP地址即为电脑的公网IP。

另一个通用的方法是：

你将看到2-3个IP地址，但你的电脑只能使用其中的一个，所以请你依次尝试一下。

这时，如果你直接在浏览器里输入你的电脑IP，应当会出现这样的页面：

如果你成功看到了这个页面，说明你的Apache2已经正确配置了。如果看不到，首先去/var/www/html目录下面看看，是否有index.html这个文件。如果没有，说明你的apache没能成功安装。如果有，就请再检查一下防火墙的设置。

刚才我们看到的页面是由html文件生成的静态网页，而MediaWiki是一种由PHP语言编写成的动态网页。Apache在读取网站的运行文件时，总会先找到一个叫做index的文件，再从index中读取它想要运行的其他内容。

因此，我们希望MediaWiki所使用的php文件能够先于html文件被找到并访问。为此，我们需要到Apache的文件夹中改变其配置文件中不同格式文件的读取顺序。输入：

之后你将看到这样的显示内容：

解释一下刚才的命令中vim的含义：vim是linux系统的一个文件编辑器，可以在命令行环境下使用。打开文件后，你会发现你无法修改，这时按I键进入INCERT模式后，便可以移动光标进行修改。

将内容中的index.php移动至最前方，仅次于DirectoryIndex的位置，如下所示：

修改完成后，按下esc键退出INCERT模式，并输入:wq（半角冒号+wq）保存并退出。之后重启Apache2：

你也可以用systemctl命令检查Apache2的状态：

如果Apache2运行正常，则会显示这样的内容：

首先，创建一个新的MySQL用户（new_mysql_user）：

此时将进入mysql的命令行界面，并输入[4]：

然后创建一个新的mysql数据库my_wiki：

然后授予你刚刚创建的mysql用户访问my_wiki的权限：

来自MediaWiki的官方教程：

本人认为这个路径和php版本有关，所以请打开/etc/php文件夹，确认你的php版本：

本人电脑上的php版本为7.2。所以打开/7.2/apache2/php.ini：

注意右下角的top，当你向下滚动光标的时候，它会提示你现在处在文件的哪个位置。你也可以按/键进入查找模式。

因为一些php脚本可能相当占用内存，所以向下滚动到约21%处，找到

将其修改为至少128M。

并向下滚动到约41%处，找到

修改为至少20M，或根据你想上传的文件大小自行调整。

根据本人实测，即使修改了upload_max_filesize，在wiki的“上传页面”进行上传的时候也会显示“最大文件限制 = 8M”，这是因为：

请自行修改至合适大小。

[^4]:这些步骤是可选的，也可以在安装之后进行。 没有这些改变MediaWiki也可以运行。

当你使用Apache2时，虚拟主机能使你用一个服务器同时支持多个网站，同时不会干扰到神秘的默认设置（本人自己的理解）。以下以your-domain作为网站名称的代指，实际应用中请将所有的your_domain更换为自己想要的网站名字。

首先，我们抛弃掉apache2默认界面所在的/var/www/html文件夹，另立门户：

其次，修改文件夹的相应权限，使得你不用超级管理员也可以访问：

然后在里面也创建一个测试用的index.html：

按I键在里面输入这些内容：

然后按esc键，输入:wq保存并离开。

之后，为了让Apache2正确识别到你的内容，你需要专门为your_domain创建一个配置文件：

并在里面输入这些内容：

然后按esc键，输入:wq保存并离开。

之后让Apache2记住这个配置文件，并忽视默认的那个配置文件：

之后检查一下配置文件的格式是否正确：

不出意外的话，应该会显示：

然后重启apache2：

然后在浏览器栏中输入http://your-domain.com或者你刚才设置的那些别名。不出意外的话，应该可以看到：

这样，你的虚拟主机就设置完成了。

在进行下一步操作之前，我们需要先测试你的apache是否支持MediaWiki所使用的php文件。

创建一个info.php：

并输入以下内容：

然后保存并退出。

然后在浏览器栏中输入http://your_domain.com/info.php。如果不出意外的话，你可以看到php的信息页面：

如果成功打开，说明你的PHP已经能成功启动了。此时就可以删掉这个临时的php文件，以免和你的其他文件起冲突：

官方压缩包下载地址：https://www.mediawiki.org/wiki/Download。有以下两种方式可选，推荐使用第一种。

[^5]: *表示你当前的版本号

在正式安装之前，你需要输入以下代码，确定所需要的PHP扩展已经打开：

然后打开浏览器，输入http://localhost/index.php（根据安装条件的不同，也可以输入http://154.xxx.xxx.xxx或者http://www.your_domain.com，并看情况在结尾加入/index.php）安装MediaWiki。

安装界面比较友好，在此不再赘述全部流程，只提醒几个需要注意的点：

需要注意的是，在数据库配置的部分，需要你回忆起之前设置的new_mysql_user账户和它的密码。

同时，你必须打开“使用超级用户账户”选项。超级用户的名称为debian-sys-maint，密码应为空（如果你没有设置过的话）。

MediaWiki预置了一些扩展[7]，建议安装以下几种：[8]

另外，还有一个非常有必要安装，但安装过程非常麻烦的插件：VisualEditor，能使用户像编辑word一样编辑wiki页面，大大降低编辑页面的成本，显著提升用户的体验和参与感。

至此，MediaWiki应该已经全部安装完成了。当你结束安装时，浏览器将下载一个名为LocalSettings.php的文件。这个文件必须被移动至放置你所有MediaWiki文件的文件夹中，即/var/www/your_domain。一般来说，默认下载路径为/downloads，所以你可以使用这样的命令：

然后将浏览器导航到你的公网ip（或域名），以查看你的新Wiki。

更多高级选项，请参见手册:在Debian或Ubuntu上运行MediaWiki的最末尾，包括文件上传、更改Logo、更多MediaWiki扩展和URL美化。

如上所述，VisualEditor是一个非常好用的图形化编辑器，极大降低了Wiki的学习成本，强烈建议安装。其基本的工作原理为：利用Parsoid服务，将VisualEditor中带有排版的富文本，转换为wiki可以识别的Wiki语法。因此，要想安装并使用VisualEditor，必须同时安装Parsoid。需要注意的是，Parsoid服务在MediaWiki 1.35版本及以上默认存在。本教程基于MediaWiki 1.34.2版本，因此需要手动安装Parsoid。

下载链接：https://www.mediawiki.org/wiki/Special:ExtensionDistributor/VisualEditor

下载并解压之后，将整个VisualEditor文件夹拷贝至/var/www/your_domain/extensions目录下。

之后，打开/var/www/your_domain的LocalSettings.php，并在最下方输入：

其他高级操作（如安装RESTBase）请参考扩展:VisualEditor。

再次声明：MediaWiki 1.35版本以上不需要手动安装Parsoid。本文基于MediaWiki 1.34.2。

导入repository gpg key（资料库密钥）：

如果第二条命令无法工作（gpgkeys: key AF380A3036A03444 canot be retrieved），则尝试下面这个：

或者这个：

然后添加Wikimedia资料库。此时需要用到刚才配置好了的代理。

首先运行clash：

然后打开浏览器栏，输入http://clash.razord.top，确认代理方式为“rules”，并且代理规则中tencentyun关键词为[DIRECT]。

回到终端，输入：

开启代理后不要关闭终端，继续输入：

其中，-E能够让apt-add-repository记住你刚才设置的代理。

然后执行安装：

apt服务也需要代理，而它的代理方式与apt-add-repository有所不同。你需要在同一行代码内单独设置一次代理：

安装成功后，你需要打开/etc/mediawiki/parsoid/config.yaml，并滚动至约50%的位置，配置Parsoid：

并在uri的引号内填写mediawiki文件中api.php的路径：

然后在domain的引号内填写你的IP地址：

注意！这里domain的内容一定要和前面VisualEditor中domain保持一致！

注意！请滚动至文件末尾，将#strictSSL: true前面的#删掉，并将值改为改为false。

之后重启Parsoid服务，并查看其状态：

打开浏览器，输入http://xxx.xxx.xxx.xxx:8142。如果Parsoid安装成功，你应该可以看到这样两句话：

这时打开你的wiki，并尝试“编辑”功能。不出意外的话，你应该可以正常使用VisualEditor了。

鉴于上面已经介绍过解压和移动的操作，在这里不再重复。

下载并将解压后的MobileFrontend文件夹放置于mediawiki文件夹下的extensions文件夹中。

MinervaNeue是Mediawiki专门为移动设备设计的特殊页面主题。在mediawiki文件夹下的skin文件夹中添加MinervaNeue文件夹（注意大小写），然后下载压缩包并将解压后的所有文件拷贝于其中。

回到LocalSettings.php，在最末尾添加：

安装即告完成。

此前我们在使用wiki的时候，浏览器地址栏里总会显示index.php，看起来很长，而且不太美观：

MediaWiki对此亦有设置的方法，可以美化URL的显示，隐藏后面一长串的内容，在此处查看具体的教程。教程中提供了一个网站，能够根据你现有的URL和你想要设置的URL，自动生成配置文件的内容。根据网站的提示，尽量在域名的后面加一个/wiki，而不是直接使用域名，如：wikipedia.org/wiki/blablabla，而不是wikipedia.org/blablabla。

需要注意的是，尽量不要使用.htaccess的方法（根据MediaWiki的解释，这种方法不稳定）。请在此处点选have root access（因此以下操作请用sudo或者root权限进行）：

或者请在填写你现有的URL之后，待页面更新后，下拉至网页底端。展开Detected Settings，选择I have root access on my server, plese output apache config.，如图：

然后将Apache Config框内的内容，复制到/etc/apache2/sites-enabled/your_domain.conf里。注意，这些内容一定要放在最后一行的前面。

然后在/var/www/your_domain/LocalSettings.php里找到相应的字段，添加网页中所说的命令，注意不能简单“替换”：

最后不要忘记重启Apache2服务：

手册:在Debian或Ubuntu上运行MediaWiki - MediaWiki关于安装服务和MySQL配置的部分（不包括Apache配置的部分，因为这个教程面向的是希望在本地使用wiki的读者）

How To Install Linux, Apache, MySQL, PHP (LAMP) stack on Ubuntu 18.04 | DigitalOcean关于Apache Virtual Host配置的部分（不包括your_domain.yaml文件内容的部分，因为servername的设置不对）

ubuntu apache2配置详解(含虚拟主机配置方法)中关于配置sites-available里your_domain.yaml文件内容中ServerName，ServerAlias和的部分。

add-apt-repository设置代理

Debian管理员手册中关于apt -o "Acquire::""的用法

Ubuntu的apt-get代理设置中-o+命令行临时带入代理的用法，注意apt-get和apt不是一个语法。

手册:在Debian或Ubuntu上运行MediaWikiMediaWiki安装教程

Extension:VisualEditorVisualEditor安装教程

ParsoidParsoid安装教程

MediaWiki 安装 VisualEditor，编辑器和 parsoid 无法连接求助最后关于404的问题，即将ParsoidConfig.js（老版本的parsoid配置文件）的ParsoidConfig.prototype.strictAcceptCheck设置成false，原帖见：httpResponse 406 from Parsoid